home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / packet / praf205e / prafeng.doc < prev    next >
Text File  |  1995-07-18  |  18KB  |  484 lines
  1.                           Praffic with TVision
  2.  
  3.                        Release 2.0 DOS and DPMI16
  4.  
  5.                Copyright 1992ñ1995 Savegnago Marco IW3FQG
  6.  
  7.  
  8.                >>> PRAFFIC IS NOT A TERMINAL PROGRAM <<<
  9.  
  10.  
  11.  
  12. Some introduction
  13. -----------------
  14. This program was made for my own hobby use only. Excuse me for the brutal
  15. form in which this text was written but I'm not a good writer also in
  16. italian language... My teachers always say that I was a good student only
  17. where I was interested.
  18.  
  19. This document will be translated from in a correct english as soon as possible!
  20. Sorry!
  21.  
  22.  
  23.  
  24. What is Praffic?
  25. ----------------
  26. Praffic is an useful program to analyze the traffic of a packet channel
  27. in union to a common TNC running in KISS or SMACK mode.
  28. The program show the details of the communications in simple manner and using
  29. an user-friendly interface (Turbo Vision Vision 2.0X Borland International 1994).
  30. The rest of the program is based on my own developed library (PKLib), that I
  31. plain (in near or far future) to distribute freely in binary form to who
  32. is interested to develop program for digital communication with NOT COMMERCIAL
  33. purposes.
  34.  
  35. Why Praffic?
  36. ------------
  37. Praffic, his idea and his kernel is the natural evolution of the batch mode
  38. program PraK that was used by me for study the behaviour of the broadcasts
  39. of packet independently from the kind of the information in air comes.
  40. The reason that has pushed me to write an implementation of AX25 (and then some
  41. program) was due to the fact that the packet radio have annoyed me for its high
  42. inefficency where (ab)used as near me.
  43. So, or I invented me anything or I would have been constrained to devote me to
  44. other (better) hobbies.
  45. But, because that the passion (that it doesn't ever die!) and to some some
  46. doubts about of the operation to regime of chaos (a few like our (medieval)
  47. city with the 20th century traffic) or to the new technologies and to the actual
  48. dimensions of the bulk of data trasmitted, I have thought to write a program
  49. that helps to analyze the actual state of the trasmission and that this is
  50. serviceable from all who are interested also if not necessarily experienced of
  51. protocols but that they can to bring always good ideas.
  52.  
  53. Finally the name... it doesn't like not even to me, so if anybody invents me
  54. one of it of interesting I have arranged to change it.
  55. And to give to him the worth!
  56.  
  57. The news of this release
  58. ------------------------
  59.  
  60. -       DPMI Version
  61. -       Management of the external MBBIOS or compatible
  62. -       Some other minor improvement
  63.  
  64. The characteristics of Praffic
  65. ------------------------------
  66.  
  67. The fundamental characteristics of the program then are the followings:
  68.  
  69. - Visualization of the traffic with TF-like presentation or Praffic completely
  70.   configurable mode with full capability of filtering and showing mode of
  71.   any aspect of AX25.
  72.  
  73. - Function to QsoSpy that allows to filter and isolate the traffic of
  74.   an individual comunication between two or more station a window with
  75.   one to one or one to many and vice versa.
  76.  
  77. - Capability (in the limits of the available memory) to open more concurrent
  78.   windows to analyze the same frame from points of different sight.
  79.  
  80. - Continuosly showing of the type of frame with the capability of inclusion or
  81.   exclusion of some or of individual analysis.
  82.  
  83. - Function MHeard to schedule of listen of the first/ last and preceding frame
  84.   the total of the transferred byte, the number and the type of each frame heard
  85.   from each individual listened to station.
  86.  
  87. - Function to Inspect on distinctive nominal or type of frame with configurable
  88.   actions.
  89.  
  90. - Function of FrameWatch on a datum frame with capability of establish
  91.   the threshold of trigger and the action to undertake a tantum or
  92.   continually on its receiption.
  93.  
  94. - Visualization of the information in a object oriented, event-driven enviroment
  95.   easy from use better if in union to a mouse, and with a EGA/VGA in
  96.   resolution of 43/ 50 lines.
  97.  
  98. - Use of a common working TNC in KISS or SMACK connected via serial COM
  99.   (full user configurable).
  100.  
  101. - Capability of use the internal driver or an external Compatible MBBIOS.
  102.  
  103. - Operation:
  104.  
  105.     - the DOS release run on a PC with MSDOS 3.3 or compatible
  106.       with any card video (Hercules, CGA, EGA/ VGA), a compatible MS mouse
  107.       and 512Kb of RAM memory.
  108.     - the DPMI release run on least an AT 80286 with 1MB of extended RAM and
  109.       and can use all the avaliable memory breaking the 640Kb memory limitation.
  110.  
  111. The release of Praffic
  112. ----------------------
  113.  
  114. If in the heading of the program to side to the number of release the label
  115. appears ALPHA, BETA or GAMMA it means that the program would can (and
  116. surely have!) be not still completely sure in operation.
  117.  
  118.  
  119. DPMI16????
  120. ----------
  121.  
  122. From the release 2.0 the program available compiled also in DPMI Protected
  123. Mode of the DOS Externder of Borland C+ 4.02.
  124. The use of the Dos Extender consents of eliminate the limitation of the
  125. 640KB of maximum memory addressable from the real mode of the microprocessor
  126. and use the full free memory in the system.
  127. For this reason the program needs of the RTM.EXE and DPMI16BI.OVL (freely
  128. redistribuible) that they must be present in the same directory or in the PATH
  129. of the system.
  130. Instead of this DPMI server you are free of use any other DPMI v0.9 compatible
  131. extender (as Windows or OS/2).
  132. The options and the operation of the program are the equivalent to that real
  133. DOS version but for varying the system configuration you can use the following
  134. system setting:
  135.  
  136. The variable of available surrounding are the followings:
  137.  
  138. EXTLEAVE [nnnn] Force the number of KB of extended memory to leave free
  139.                 (default 64k)
  140. EXTMAX [nnnn]   Force the maximum number of KB of extended memory to allocate.
  141.                 The default allocate all the extended memory.
  142.  
  143. EXTMIN [nnnn]   Force the mininum value of extended memory need to run
  144.  
  145. REALLEAVE [nnnn] Force the number of KB of real memory (< of 1MB) from leave
  146.                  free (default 64k)
  147. REALMAX [nnnn]   Forces the maximum number of KB of conventional memory to
  148.                  allocate. The default allocate all the conventional memory.
  149.  
  150. REALMIN [nnnn]   Force the minimin value of real memory need to run.
  151.  
  152. Note:   [nnnn] can be a decimal number or, if preceded from the 'x' character
  153. is interpreted as hex:
  154.  
  155.         1000 [xABCD]
  156.  
  157. ATTENTION!!! The above variables has effect using the furnished DPMI Server
  158. Borland. If you are using Windows or OS/2 DPMI server refer to the relative
  159. manuals.
  160.  
  161.  
  162. Why still the DOS???
  163. --------------------
  164.  
  165. In the actual state of the operating systems the DOS is the unique that
  166. still allows to have good throughputs in terminus of speed of visualization
  167. and of management of the serial on system not particularly gifted of dedicated
  168. hardware or portable computer.
  169. I have thought much to a different way of represent the information of a
  170. packet radio channel (with charts, imagery designs boh!) and after different
  171. proofs (exist also a prototype that run under Windows) I have thought to
  172. complete a version the could run on my ATtila.
  173. If anybody has good idea or anything other I am always here ready to listen to
  174. it!!
  175. The base of development of the program is the PKLib library with which I hope
  176. to complete the transport of the next release of the program in an other
  177. operating system.
  178.  
  179.  
  180. What do you use this program for?
  181. ---------------------------------
  182. Praffic basically wants to try understand with the help of any experienced or
  183. inexperienced observer, what don't function in the actual and diffuse protocol
  184. of digital communication and try to be an easy system to use for alter and
  185. to perform measures on the proofs and experiments.
  186. The heart of Praffic in fact, is based on the classes of PKLib 2.0 (Copyright
  187. (c) 1991ñ1995 Savegnago Marco), a collection of written objects, rewritten
  188. and distorted more times from the subscribed in the intent of realize a series
  189. of components quickly reusable for the creation of digital-comunication
  190. application.
  191.  
  192. Additionally Praffic, can be used evenly like tool of filter and for deciphers
  193. from the SWL stations.
  194.  
  195.  
  196. How to use Praffic
  197. ------------------
  198.  
  199. The program functions with a common TNC running in KISS or SMACK mode.
  200. You can set the TNC to this mode both internally of the program (before opening
  201. comunication with the device) or at startup.
  202. If there is some problem managing the TNC the program popup with a Dialog Box
  203. with the warning "Kiss Timeout."
  204. If this happen try to restart and reset TNC in KISS mode.
  205. Once started the program presents itself in the classical Turbo Vision
  206. enviroment where is possibile to interact with mouse or keyboard.
  207. The principal functions of the program are accessible from the mail menu View:
  208.  
  209. - Monitor
  210. - QsoSpy
  211. - Mheard
  212. - Inspect
  213. - FrameWatch
  214.  
  215.  
  216. > MONITOR<
  217.  
  218. The view MONITOR consents to monitor the AX25 packet traffic (Level 2 and
  219. FRMR, Netrom 3/ 4 and Broadcast) in manner completely configurable both
  220. for what to show and how to display.
  221. There is 2 kind of monitor header format: TheFirmware like or original Praffic.
  222. Using the options dialogs is possibile to configure any part of the frame
  223. to be displayed.
  224.  
  225. > QSOSPY<
  226.  
  227. The QsoSpy view consents to monitor a conversation among two stations or groups
  228. of stations. Through the wildcard applied the callsign is possible monitor
  229. groups of callsigns:
  230.  
  231. IW3FQG->*     = IW3FQG-0 toward all and vice versa.
  232. *-> IW3FQG     = all toward IW3FQG-0 and vice versa.
  233. IW3F*-> I3KUH= Any call that coincides to IW3F* toward I3KUH
  234.  
  235. Like for the monitor also this view is completely configurable.
  236.  
  237. > MHEARD<
  238.  
  239. The Mheard view consents to display the strip of the stations you listen to
  240. from the beginning of the execution of the program with full info about the
  241. number of frame received,
  242. For the complete detail of the frame trasmitted from the station use the
  243. use an inspector.
  244.  
  245. > INSPECTOR<
  246.  
  247. The Inspector view displays all the relative information in the detail
  248. to a call listened to in the strip of Mheard.
  249. The available data are:
  250.  
  251.          "Call"  -> Callsign listened to
  252.         " 1st"   -> Time of the first listened frame
  253.          "Prev"  -> Time of the previous listened frame
  254.          "Last"  -> Time of the last listened frame
  255.          "The#"  -> Number of frames The listened to
  256.          "The"   -> Numbers of contained bytes in frame The listened to
  257.          "RR#"   -> Number of RR frame listened
  258.          "REJ#"  -> Number of REJ frame listened
  259.          "RNR#"  -> Number of RNR frame listened
  260.          "SREJ#" -> Number of SREJ frame listened (*)
  261.          "UI#"   -> Number of UI frame listened
  262.          "UI"    -> Numbers of bytes in UI frame listened
  263.          "DM#"   -> Number of DM frame listened
  264.          "SABM#" -> Number of SABM frame listened
  265.          "DISC#" -> Number of DISC frame listened
  266.          "UA#"   -> Number of UA frame listened
  267.          "FRMR#" -> Number of FRMR frame listened
  268.  
  269.          "TOTAL" -> Number of total frames of listened
  270.  
  271.  
  272.  
  273.  (*) Ths SREJ frame is not available on the standard AX25 L2.
  274.  
  275.  
  276.  
  277. > FRAMEWATCH<
  278.  
  279. A FrameWatch consents of establish that on the receipt of a datum frame
  280. (of one or more call, or on the content of a data) the program undertakes a
  281. definite action of warning or message or of monitor.
  282. The available actions in this moment are beyond to a simple acoustic and visual
  283. message, the appearance of a message in the log, the activation of a SpyView,
  284. the activation or disattivazione linked of an other framewatch etc..
  285. The threshold of intervention adjustable is on the number of received frame.
  286. The FrameWatch can be modified runtime or activated/ deactivated by hotkey.
  287.  
  288.  
  289. Integrate SetKiss
  290. -----------------
  291.  
  292. With version 1.1 I've integrated the SetKiss function directly on the Main
  293. menu of Praffic.
  294. The selection dialog allow to use the 4 main type of configuration string
  295. for the most diffuse TNC type:
  296.  
  297. TAPR TNC2         "KISS ON\rRESTART\ r"
  298. TF 2.X            "\ x11\ x18\ x1b@ K\ r"
  299. AEA   "CONMODE TRANS ON\rPP ON\rRAW OFF\rHP ON\r KISS ON \r HOST\r"
  300. KANTRONICS 2.X  "KISSMODE ON\rRESET\r"
  301. KANTRONICS 3.X  "INTFACE KISS\rRESET\r"
  302.  
  303. The fifth selection consents of send the sequence for exit from kiss mode
  304. "\xC0\xFF\xC0" while the sixth selection allows to send a customizable
  305. command.
  306.  
  307.  
  308. The interface used in Praffic with TVision
  309. ------------------------------------------
  310.  
  311. The interface used in Praffic with TVision is the standard Borland Turbo Vision
  312. interface available in both C++ and Turbo Pascal languages.
  313. It acts as the most modern graphical user interface in character mode, offering
  314. good performace and a similar programming enviroment available in Windows or
  315. OS/2 operating system.
  316.  
  317.  
  318. The mouse in Praffic
  319. --------------------
  320. The mouse in Praffic is very important. I this it is essential in many cases,
  321. where for example some function are activable only using it.
  322. Remember to use the right click of the mouse on every view to see the option
  323. available for that view.
  324.  
  325.  
  326. The options of command line of Praffic
  327. --------------------------------------
  328.  
  329. The options of command line consent of modify the default settings of the
  330. program for the serial / video or other thing:
  331.  
  332. / Cc- Set the communication port to use 1|2|3|4
  333.            eg: / C2= COM2
  334.  
  335. / D- Search for the presence of DesqView and if so force the use of its
  336.      virtual screen pointer
  337.  
  338. / K[T|H|T|O|K]- Send on execute the KISS to the TNC using the parameter
  339.         compatible with:
  340.  
  341.                 T= TAPR TNC2 or clones with eprom 1.xx
  342.                 H= TAPR TNC2 or clones with eprom HOST TheFirmware
  343.                 T= TNC AEA
  344.                 O= TNC Kantronics with eprom 2.XX
  345.                 K= TNC Kantronics with eprom 3.XX
  346.  
  347. / The- Specify the interrupt to use
  348.  
  349. / L Send on shutdown the standard leave KISS string to TNC.
  350.  
  351. / M[I|M]- Specific if use the driver I)NTERNAL or M)BBIOS
  352.  
  353. / N- Avoid snow checking on CGA
  354.  
  355. / P- Specify the address of com to use
  356.  
  357. / Ss- Set the com speed among one of the followings:
  358.             (3)00 (1)200 (2)400 (4)800 (9)600 192(0)0 3(8)400 5(7)600
  359.             11(5)200 baud eg: / S0= 19200
  360.  
  361. / T[C|I]- Tell to the program if use the COM parameter or the ADDRESS parameter
  362.           for COM port to use (only for the internal driver).
  363.  
  364. /?| H- Show this text
  365.  
  366.  
  367.  
  368. The configuration of Praffic
  369. ----------------------------
  370. The program was written to be used intelligently from persons with a certain
  371. culture in field of TNC, addresses and interrupt of seriali, custom
  372. and configuration of driver which MBBIOS etc.
  373. Certain is that the program NOT E' WRITTEN STATE To God PROOF IDIOT also if
  374. nowadays almost all the commercial programs are!
  375.  
  376. With the internal driver the program has a predefined the following values of
  377. COM:
  378.  
  379.         COM1-> Address= 0x3F8, Irq= 4
  380.     COM2-> Address= 0x2F8, Irq= 3
  381.         COM3-> Address= 0x3E8, Irq= 4
  382.     COM4-> Address= 0x2E8, Irq= 3
  383.  
  384. Beyond to COM4 the values are repeated so COM5 are as COM1 end so on...
  385.  
  386. For the external driver see its documentation.
  387.  
  388.  
  389. The Praffic author
  390. ------------------
  391.  
  392. This text is not written with the intent of furnish a manual detailed for the
  393. minus experienced users. The program alone is one tool for effect an analysis
  394. of the packet radio traffic and like such go advised and used!
  395. The program comes furnished without no warranty and the author can decide
  396. to alter it any time or drop the free distibution in each moment.
  397. If anybody finds any error or has any good idea or hint (not personal
  398. adaptations pse!) can send to me a letter or WRITTEN message, NOT to words
  399. (radio, telephone, intercom.).
  400.  
  401. My address is:
  402.  
  403.         Marco Savegnago
  404.         Stradella Ospedale 87
  405.         36100 Vicenza
  406.         Italy
  407.  
  408. In Packet-Radio:
  409.  
  410.         IW3FQG@I3KUH.IVEN.ITA.EU
  411.  
  412. In Internet:
  413.  
  414.         mc2365@mclink.it
  415.  
  416.  
  417.  
  418. Copyright of Praffic
  419. --------------------
  420.  
  421. The Praffic program and his components are freely copyable and dispensable in
  422. any form only for amateur radio purposes and from which however could not draw
  423. aside profit.
  424. Is also forbidden to use the program for demonstration in commercial private
  425. and public businnes, institutional, towns, regional, statal and governments.
  426. Any type of commercial exploitation not expressly authorized from the author is
  427. to consider forbidden! 
  428. No responsability is attributable to the author if the program during
  429. its execution procures blocks that could cause the loss of data or malfunctions
  430. of the computer.
  431.  
  432. Copyright (c) 1995 Savegnago Marco. All right reserved.
  433.  
  434.  
  435.  
  436. Personal considerations on the program
  437. --------------------------------------
  438.  
  439. To many a program of the kind not nothing or serve to nothing but other
  440. that they from the first distribution have written me or phoned they have
  441. appreciated it and they have suggested me different ideas.
  442. Many things that I have been suggested like the simulation of traffic to test
  443. a link or the random frame generation, or the packet cracking function is
  444. included in my personal version of the program.
  445. I don't believe that I distribute it freely.
  446. This for prevent that some guy to act some thing ... in good or bad faith
  447. could misuse and disturb, without the practical to be discovered.
  448. The distributed copy freely doesn't contain all the available functions of the
  449. original for avoid of be the unintentional cause of troubles.
  450.  
  451.  
  452.  
  453.  
  454.  
  455. Possible additions to the next releases
  456. ---------------------------------------
  457.  
  458. -       Management of HDLC modem connected directly to the COM
  459.         (BAYCOM like) to see all really, flags txdelay axdelay fcs error...
  460. -       Simulation of traffic!!
  461. -       Random Generation of frame
  462. -       Terminal
  463. -       Decoding of other protocols
  464. -       Multiport
  465.  
  466.  
  467.  
  468. Fonts and bibliographic references
  469. ---------------------------------
  470.  
  471. -       Implementation of AX25 in the NOS program of KA9Q
  472.  
  473. -       Implementation of AX25 of the TheFirmware program of the group German
  474.         NORTH><LINK
  475.  
  476. -       Tanenbaum, Andrew S., "Networks Computer" pp.  288-292.
  477.     Prentice-Hall 1981.
  478.  
  479. -    X.25 MADE EASY Nicolas M.Thrope, Derek Ross
  480.     Prentice-Hall 1992.
  481.  
  482.  
  483.  
  484.